Skip to content

Check point analysis 1.1.1 Text Alternatives - Images ​

⚠️ Actualmente no está en producción. Este checkpoint no forma parte del producto en vivo por ahora: los modelos de clasificación de imágenes en los que se apoyaba fueron discontinuados. Su integración está prevista para una próxima versión.

Ally ​

Este criterio establece que todo contenido no textual que se presente al usuario debe contar con un texto alternativo que cumpla la misma función o propósito. En el caso de las imágenes, esto significa que se debe identificar qué rol cumplen en la interfaz para determinar si requieren descripción, pueden quedar marcadas como decorativas o si son elementos interactivos que necesitan un nombre accesible.


Estrategia Programática en el Detector ​

El análisis se compone de dos fases complementarias:

1. Identificación y Clasificación Visual ​

  • Utilizamos Computer Vision para detectar elementos en la página que tengan apariencia de imagen (no sólo <img>, sino también:
    • SVG embebidos,
    • Canvas
  • A partir de esta detección, se clasifican según su posible rol funcional en la UI.

2. Ajuste Interactivo mediante Prompt ​

  • El resultado preliminar se pasa a un módulo LLM que enriquece el razonamiento contextual.

  • El evaluador o QA puede ayudar a ajustar prompts para mejorar precisión en:

    • Contexto de uso
    • Jerarquía visual
    • Rol comunicativo del elemento

Esto permite adaptar la clasificación a diferentes patrones de diseño sin perder consistencia.


Clasificación Funcional de Imágenes ​

Tipo de ImagenCaracterísticasTratamiento en el Detector
Decorativas- Marcadas explícitamente como decorativas (alt="", aria-hidden, role="presentation")
- No transmiten información relevante
- No son interactivas
- Ubicadas en zonas repetitivas como headers, fondos, separadores
No deben reportarse como error. Se valida que su marcado sea correcto. De no estar marcado adecuadamente → Se sugiere marcar como decorativa.
Informativas- Transmiten contenido o contexto relevante
- Generalmente se encuentran en áreas de contenido
- Suelen acompañarse de texto descriptivo o títulos
Se verifica que cuenten con alt significativo. Si falta o es poco descriptivo → Reportar issue 1.1.1 Informational Image Missing/Insufficient Alternative Text.
Activas (Interactivas)- Parte de un control o acción (<a>, <button>, elementos con onclick, tabindex, role="button", etc.)
- Sirven para navegar, abrir, expandir, guardar, enviar, etc.
Deben contar con nombre accesible. Se valida aria-label, alt, aria-labelledby o contenido textual visible. Si carece → Reportar como 4.1.2 Name, Role, and Value (además de 1.1.1 si aplica).

Resultado Esperado ​

El detector:

  1. Identifica imágenes mediante visión computacional.
  2. Clasifica según función visual-contextual.
  3. Valida la presencia y calidad del texto alternativo.
  4. Reporta únicamente los casos donde el marcado es incorrecto, insuficiente o ausente.

Esto garantiza:

  • Reducción de falsos positivos en imágenes decorativas.
  • Priorización de errores con impacto real en usabilidad.
  • Cohesión con prácticas de auditoría manual.